package com.campus.help.service;

import java.util.List;
import java.util.Map;

/**
 * 仪表盘服务接口
 *
 * @author campus-help
 * @since 2024-01-29
 */
public interface DashboardService {

    /**
     * 获取仪表盘统计数据
     *
     * @return 统计数据
     */
    Map<String, Object> getDashboardStats();

    /**
     * 获取最近任务
     *
     * @param limit 限制数量
     * @return 最近任务列表
     */
    List<Map<String, Object>> getRecentTasks(Integer limit);

    /**
     * 获取系统通知
     *
     * @param limit 限制数量
     * @return 通知列表
     */
    List<Map<String, Object>> getNotifications(Integer limit);

    /**
     * 获取任务类型分布
     *
     * @return 任务类型分布数据
     */
    List<Map<String, Object>> getTaskDistribution();

    /**
     * 获取用户活跃度数据
     *
     * @param days 天数
     * @return 用户活跃度数据
     */
    List<Map<String, Object>> getUserActivity(Integer days);
}
